home *** CD-ROM | disk | FTP | other *** search
/ Chip 2007 January, February, March & April / Chip-Cover-CD-2007-02.iso / Pakiet bezpieczenstwa / mini Pentoo LiveCD 2006.1 / mpentoo-2006.1.iso / livecd.squashfs / usr / include / gtk-2.0 / gtk / gtkfilechooser.h < prev    next >
Encoding:
C/C++ Source or Header  |  2006-04-25  |  8.0 KB  |  189 lines
  1. /* GTK - The GIMP Toolkit
  2.  * gtkfilechooser.h: Abstract interface for file selector GUIs
  3.  * Copyright (C) 2003, Red Hat, Inc.
  4.  *
  5.  * This library is free software; you can redistribute it and/or
  6.  * modify it under the terms of the GNU Lesser General Public
  7.  * License as published by the Free Software Foundation; either
  8.  * version 2 of the License, or (at your option) any later version.
  9.  *
  10.  * This library is distributed in the hope that it will be useful,
  11.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13.  * Lesser General Public License for more details.
  14.  *
  15.  * You should have received a copy of the GNU Lesser General Public
  16.  * License along with this library; if not, write to the
  17.  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  18.  * Boston, MA 02111-1307, USA.
  19.  */
  20.  
  21. #ifndef __GTK_FILE_CHOOSER_H__
  22. #define __GTK_FILE_CHOOSER_H__
  23.  
  24. #include "gtkfilefilter.h"
  25. #include <gtk/gtkwidget.h>
  26.  
  27. G_BEGIN_DECLS
  28.  
  29. #define GTK_TYPE_FILE_CHOOSER             (gtk_file_chooser_get_type ())
  30. #define GTK_FILE_CHOOSER(obj)             (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_FILE_CHOOSER, GtkFileChooser))
  31. #define GTK_IS_FILE_CHOOSER(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_FILE_CHOOSER))
  32.  
  33. typedef struct _GtkFileChooser      GtkFileChooser;
  34.  
  35. typedef enum
  36. {
  37.   GTK_FILE_CHOOSER_ACTION_OPEN,
  38.   GTK_FILE_CHOOSER_ACTION_SAVE,
  39.   GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER,
  40.   GTK_FILE_CHOOSER_ACTION_CREATE_FOLDER
  41. } GtkFileChooserAction;
  42.  
  43. typedef enum
  44. {
  45.   GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM,
  46.   GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME,
  47.   GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN
  48. } GtkFileChooserConfirmation;
  49.  
  50. GType gtk_file_chooser_get_type (void) G_GNUC_CONST;
  51.  
  52. /* GError enumeration for GtkFileChooser */
  53.  
  54. #define GTK_FILE_CHOOSER_ERROR (gtk_file_chooser_error_quark ())
  55.  
  56. typedef enum {
  57.   GTK_FILE_CHOOSER_ERROR_NONEXISTENT,
  58.   GTK_FILE_CHOOSER_ERROR_BAD_FILENAME
  59. } GtkFileChooserError;
  60.  
  61. GQuark gtk_file_chooser_error_quark (void);
  62.  
  63. /* Configuration
  64.  */
  65. void                 gtk_file_chooser_set_action          (GtkFileChooser       *chooser,
  66.                                GtkFileChooserAction  action);
  67. GtkFileChooserAction gtk_file_chooser_get_action          (GtkFileChooser       *chooser);
  68. void                 gtk_file_chooser_set_local_only      (GtkFileChooser       *chooser,
  69.                                gboolean              local_only);
  70. gboolean             gtk_file_chooser_get_local_only      (GtkFileChooser       *chooser);
  71. void                 gtk_file_chooser_set_select_multiple (GtkFileChooser       *chooser,
  72.                                gboolean              select_multiple);
  73. gboolean             gtk_file_chooser_get_select_multiple (GtkFileChooser       *chooser);
  74. void                 gtk_file_chooser_set_show_hidden     (GtkFileChooser       *chooser,
  75.                                gboolean              show_hidden);
  76. gboolean             gtk_file_chooser_get_show_hidden     (GtkFileChooser       *chooser);
  77.  
  78. void                 gtk_file_chooser_set_do_overwrite_confirmation (GtkFileChooser *chooser,
  79.                                      gboolean        do_overwrite_confirmation);
  80. gboolean             gtk_file_chooser_get_do_overwrite_confirmation (GtkFileChooser *chooser);
  81.  
  82. /* Suggested name for the Save-type actions
  83.  */
  84. void     gtk_file_chooser_set_current_name   (GtkFileChooser *chooser,
  85.                           const gchar    *name);
  86.  
  87. /* Filename manipulation
  88.  */
  89. #ifdef G_OS_WIN32
  90. /* Reserve old names for DLL ABI backward compatibility */
  91. #define gtk_file_chooser_get_filename gtk_file_chooser_get_filename_utf8
  92. #define gtk_file_chooser_set_filename gtk_file_chooser_set_filename_utf8
  93. #define gtk_file_chooser_select_filename gtk_file_chooser_select_filename_utf8
  94. #define gtk_file_chooser_unselect_filename gtk_file_chooser_unselect_filename_utf8
  95. #define gtk_file_chooser_get_filenames gtk_file_chooser_get_filenames_utf8
  96. #define gtk_file_chooser_set_current_folder gtk_file_chooser_set_current_folder_utf8
  97. #define gtk_file_chooser_get_current_folder gtk_file_chooser_get_current_folder_utf8
  98. #define gtk_file_chooser_get_preview_filename gtk_file_chooser_get_preview_filename_utf8
  99. #define gtk_file_chooser_add_shortcut_folder gtk_file_chooser_add_shortcut_folder_utf8
  100. #define gtk_file_chooser_remove_shortcut_folder gtk_file_chooser_remove_shortcut_folder_utf8
  101. #define gtk_file_chooser_list_shortcut_folders gtk_file_chooser_list_shortcut_folders_utf8
  102. #endif
  103.  
  104. gchar *  gtk_file_chooser_get_filename       (GtkFileChooser *chooser);
  105. gboolean gtk_file_chooser_set_filename       (GtkFileChooser *chooser,
  106.                           const char     *filename);
  107. gboolean gtk_file_chooser_select_filename    (GtkFileChooser *chooser,
  108.                           const char     *filename);
  109. void     gtk_file_chooser_unselect_filename  (GtkFileChooser *chooser,
  110.                           const char     *filename);
  111. void     gtk_file_chooser_select_all         (GtkFileChooser *chooser);
  112. void     gtk_file_chooser_unselect_all       (GtkFileChooser *chooser);
  113. GSList * gtk_file_chooser_get_filenames      (GtkFileChooser *chooser);
  114. gboolean gtk_file_chooser_set_current_folder (GtkFileChooser *chooser,
  115.                           const gchar    *filename);
  116. gchar *  gtk_file_chooser_get_current_folder (GtkFileChooser *chooser);
  117.  
  118.  
  119. /* URI manipulation
  120.  */
  121. gchar *  gtk_file_chooser_get_uri                (GtkFileChooser *chooser);
  122. gboolean gtk_file_chooser_set_uri                (GtkFileChooser *chooser,
  123.                           const char     *uri);
  124. gboolean gtk_file_chooser_select_uri             (GtkFileChooser *chooser,
  125.                           const char     *uri);
  126. void     gtk_file_chooser_unselect_uri           (GtkFileChooser *chooser,
  127.                           const char     *uri);
  128. GSList * gtk_file_chooser_get_uris               (GtkFileChooser *chooser);
  129. gboolean gtk_file_chooser_set_current_folder_uri (GtkFileChooser *chooser,
  130.                           const gchar    *uri);
  131. gchar *  gtk_file_chooser_get_current_folder_uri (GtkFileChooser *chooser);
  132.  
  133. /* Preview widget
  134.  */
  135. void       gtk_file_chooser_set_preview_widget        (GtkFileChooser *chooser,
  136.                                GtkWidget      *preview_widget);
  137. GtkWidget *gtk_file_chooser_get_preview_widget        (GtkFileChooser *chooser);
  138. void       gtk_file_chooser_set_preview_widget_active (GtkFileChooser *chooser,
  139.                                gboolean        active);
  140. gboolean   gtk_file_chooser_get_preview_widget_active (GtkFileChooser *chooser);
  141. void       gtk_file_chooser_set_use_preview_label     (GtkFileChooser *chooser,
  142.                                gboolean        use_label);
  143. gboolean   gtk_file_chooser_get_use_preview_label     (GtkFileChooser *chooser);
  144.  
  145. char *gtk_file_chooser_get_preview_filename (GtkFileChooser *chooser);
  146. char *gtk_file_chooser_get_preview_uri      (GtkFileChooser *chooser);
  147.  
  148. /* Extra widget
  149.  */
  150. void       gtk_file_chooser_set_extra_widget (GtkFileChooser *chooser,
  151.                           GtkWidget      *extra_widget);
  152. GtkWidget *gtk_file_chooser_get_extra_widget (GtkFileChooser *chooser);
  153.  
  154. /* List of user selectable filters
  155.  */
  156. void    gtk_file_chooser_add_filter    (GtkFileChooser *chooser,
  157.                     GtkFileFilter  *filter);
  158. void    gtk_file_chooser_remove_filter (GtkFileChooser *chooser,
  159.                     GtkFileFilter  *filter);
  160. GSList *gtk_file_chooser_list_filters  (GtkFileChooser *chooser);
  161.  
  162. /* Current filter
  163.  */
  164. void           gtk_file_chooser_set_filter (GtkFileChooser *chooser,
  165.                        GtkFileFilter  *filter);
  166. GtkFileFilter *gtk_file_chooser_get_filter (GtkFileChooser *chooser);
  167.  
  168. /* Per-application shortcut folders */
  169.  
  170. gboolean gtk_file_chooser_add_shortcut_folder    (GtkFileChooser *chooser,
  171.                           const char     *folder,
  172.                           GError        **error);
  173. gboolean gtk_file_chooser_remove_shortcut_folder (GtkFileChooser *chooser,
  174.                           const char     *folder,
  175.                           GError        **error);
  176. GSList *gtk_file_chooser_list_shortcut_folders   (GtkFileChooser *chooser);
  177.  
  178. gboolean gtk_file_chooser_add_shortcut_folder_uri    (GtkFileChooser *chooser,
  179.                               const char     *uri,
  180.                               GError        **error);
  181. gboolean gtk_file_chooser_remove_shortcut_folder_uri (GtkFileChooser *chooser,
  182.                               const char     *uri,
  183.                               GError        **error);
  184. GSList *gtk_file_chooser_list_shortcut_folder_uris   (GtkFileChooser *chooser);
  185.  
  186. G_END_DECLS
  187.  
  188. #endif /* __GTK_FILE_CHOOSER_H__ */
  189.